Skip to content

docs: add phantom_loop documentation#13

Closed
electronicBlacksmith wants to merge 3 commits intoworktree-fix+loop-slack-feedbackfrom
docs/loop-documentation
Closed

docs: add phantom_loop documentation#13
electronicBlacksmith wants to merge 3 commits intoworktree-fix+loop-slack-feedbackfrom
docs/loop-documentation

Conversation

@electronicBlacksmith
Copy link
Copy Markdown
Owner

Summary

  • Adds docs/loop.md covering the full phantom_loop system: MCP tool parameters, state file contract, tick lifecycle, Slack integration, mid-loop critique, post-loop pipeline, memory context, and goal-writing tips
  • Adds loop docs link to CLAUDE.md Further Reading table
  • Written against the PR feat(loop): integrate evolution, memory, and mid-loop critique #9 branch since it documents features from that PR (critique, post-loop, memory injection)

Test plan

  • Cross-referenced all parameters against LoopStartInputSchema in src/loop/types.ts
  • Cross-referenced tick lifecycle against tick() in src/loop/runner.ts
  • Cross-referenced critique flow against src/loop/critique.ts
  • Cross-referenced post-loop pipeline against src/loop/post-loop.ts
  • Verified buildSafeEnv env vars match src/mcp/dynamic-handlers.ts
  • Style consistent with existing docs (memory.md, channels.md)
  • Reviewed by Opus 4.6 and Haiku 4.5 for accuracy and redundancy
  • bun run lint clean
  • bun run typecheck clean

Closes #12

electronicBlacksmith and others added 3 commits April 5, 2026 18:36
Closes #5.

AsyncLocalStorage context injection, reaction ladder, progress bar,
state.md summary on completion. Stop button persists across tick edits.
Tick/finalize race eliminated. LoopNotifier extracted from runner.ts.

Verified end-to-end in Slack + non-Slack trigger. 945 tests passing.
Covers MCP tool parameters, state file contract, tick lifecycle,
Slack integration, mid-loop critique, post-loop evolution pipeline,
memory context injection, and tips for writing effective goals.

Closes #12
PR #7 was squash-merged into main while PR #9's branch still had the
original commits. Conflicts were all additive - kept PR #9's features
(checkpoint_interval, memory context, critique, post-loop pipeline)
while adopting main's improved error formatting and race condition
comment in the tick update await.
@electronicBlacksmith
Copy link
Copy Markdown
Owner Author

Superseded by #14 (consolidated clean branch)

@electronicBlacksmith electronicBlacksmith deleted the docs/loop-documentation branch April 6, 2026 23:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant